package com.example.demo.service;

import com.example.demo.entity.Province;

import java.util.List;

/**
 * 地理位置省份服务层接口
 *
 * @author 叮当猫的百宝箱
 * @since 1.0
 */
public interface ProvinceService {

    /**
     * 获取全部省份信息列表
     *
     * @return 全部省份信息列表
     */
    List<Province> getAllProvinces();

    /**
     * 根据城市行政编码获取所属的省份信息
     *
     * @param cityCode 城市行政编码
     * @return 市行政编码获取所属的省份信息
     */
    Province getByCityCode(String cityCode);

    /**
     * 根据区/县行政编码获取所属的省份信息
     *
     * @param districtCode 区/县行政编码
     * @return 区/县行政编码所属的省份信息
     */
    Province getByDistrictCode(String districtCode);

    /**
     * 根据镇/街道行编码获取所属的省份信息
     *
     * @param townCode 镇/街道行政编码
     * @return 镇/街道行编码所属的省份信息
     */
    Province getByTownCode(String townCode);
}
